Spring Cloud Alibaba系列教程-04-使用Nacos管理配置

点击上方 IT牧场 ，选择 置顶或者星标技术干货每日送达！

之前，笔者详细探讨了如何使用 Spring Cloud Config 管理配置，详见：

本节来探讨如何使用Nacos管理配置。

Nacos管理配置

1 进入Nacos控制台，点击导航栏的“配置列表”，然后点击右侧的“+” 按钮，如下图所示：

2 即可看到类似下图的界面：

其中，dataId 的完整格式为：${prefix}-${spring.profile.active}.${file-extension} 。

•prefix 默认为 spring.application.name 的值，也可以通过配置项 spring.cloud.nacos.config.prefix来配置。•spring.profile.active 即为当前环境对应的 profile，详情可以参考 Spring Boot文档^[1]。注意：当 spring.profile.active 为空时，对应的连接符 - 也将不存在，dataId 的拼接格式变成${prefix}.${file-extension}•file-exetension 为配置内容的数据格式，可以通过配置项 spring.cloud.nacos.config.file-extension 来配置。目前只支持 properties 和 yaml 类型。

编码

1 添依赖：

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  </dependency>
</dependencies>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-dependencies</artifactId>
      <version>Greenwich.RELEASE</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
    <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
      <version>0.2.1.RELEASE</version>
    </dependency>
  </dependencies>
</dependencyManagement>

2 加注解：

@SpringBootApplication
public class ConfigClientApplication {
  public static void main(String[] args) {
    SpringApplication.run(ConfigClientApplication.class, args);
  }
}

3 写配置：bootstrap.yml

spring:
  application:
    name: microservice-foo
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        # 指定group
        group: DEFAULT_GROUP
        # 文件后缀，默认为properties
        file-extension: properties
  profiles:
    active: dev

4 写配置：application.yml

server:
  port: 8081

5 编写Controller：

@RestController
@RefreshScope
public class ConfigClientController {
  @Value("${profile}")
  private String profile;

  @GetMapping("/profile")
  public String hello() {
    return this.profile;
  }
}

如代码所示，这里使用@Value("${profile}") 引用了一个名为profile 的配置属性。该配置属性使用Nacos进行管理。（dev-1.0）

测试1：配置管理

1 启动应用，可看到类似如下的日志：

2019-02-15 22:13:14.472  INFO 4474 --- [           main] o.s.c.a.n.c.NacosPropertySourceBuilder   : Loading nacos data, dataId: 'microservice-foo-dev.properties', group: 'DEFAULT_GROUP'
2019-02-15 22:13:14.473  INFO 4474 --- [           main] b.c.PropertySourceBootstrapConfiguration : Located property source: CompositePropertySource {name='NACOS', propertySources=[NacosPropertySource {name='microservice-foo-dev.properties'}, NacosPropertySource {name='microservice-foo.properties'}]}

这两行日志比较重要，它告诉我们当前应用获取了Nacos中的哪些配置文件。

2 访问http://localhost:8081/profile ，返回dev-1.0

测试2：配置刷新

1 将配置修改为dev-2.0 ，并发布，如下图：

2 再次访问http://localhost:8081/profile ，返回dev-2.0

3 可打印类似如下的日志：

2019-02-15 22:16:07.237  INFO 4474 --- [-127.0.0.1_8848] o.s.c.e.event.RefreshEventListener       : Refresh keys changed: [profile]

该日志也比较重要，它告诉我们哪些配置属性刷新了。

注意点

•Nacos中的Data ID的格式务必写对，和应用对应，否则无法正确找到相应配置文件；•要想刷新配置属性，@RefreshScope 不能少，否则配置无法正常刷新。

干货分享

最近将个人学习笔记整理成册，使用PDF分享。关注我，回复如下代码，即可获得百度盘地址，无套路领取！

•001：《Java并发与高并发解决方案》学习笔记；•002：《深入JVM内核——原理、诊断与优化》学习笔记；•003：《Java面试宝典》•004：《Docker开源书》•005：《Kubernetes开源书》•006：《DDD速成（领域驱动设计速成）》

近期热文

关注我

References

[1] Spring Boot文档: https://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-profiles.html#boot-features-profiles

点"在看"是一种美德^_^